WWWworkbenchIB v 1.0
(IB=version that runs on IBrowse )
by Andres Pääbo ©98 Shareware-US$5
Introduction
PREFACE
This project developed as a result of my doing some commercial work creating websites with lots of graphics (see later for some of my websites). In the process of creating websites with a nice graphic appearance, it is necessary to view what you have visually. Thumbnail systems have the problem that you have to deliberately create the thumbnails. Also not all software support the same thumbnails (ie for loading and saving). Thirdly, if you move files, the thumbnails will not move with the file (except for newicons, and thumbnails that are actually put onto the workbench icons--but when thumbnails are put on workbench icons, the workbench slows down ...and so it goes....)
But for website work how necessary are permanent thumbnails anyway? Websites are designed to travel over phone lines, and most images used should be under 15k so as not to try the average internet user's patience. Website images arrive quickly. So they do not need thumbnails. They only need to be scaled to a fixed size and layed out on the screen for easy viewing. The HTML parameters of WIDTH= and LENGTH= for images, make borwsers natural image scalers. So why not load all images, from their source, and generate a temporary html document with images required to be scaled to a specified WIDTH and HEIGHT.
It is relatively easy to do, and some others have done so.
But when I began doing so, I started running into real world problems and requirements. What is the file name? What is its filesize? How would yoou use browser displays of directory contents? What about non-images in the directories? What about directories? What about navigation? What can we do with the thumnail display when it is created? One answer led to another and another and eventually the result is WWWworkbench.
It is called this because in its final form it resembles a workbench. You open many browser windows each with thumbnail -size displays, and perfprm typical directory editing actions on them--just like regular workbench windows. IBrowse allows all the gadgets to be removed from the browser window, and it really looks like a workbench window!!! However, the limited nature of IBrowse arexx command makes it behave a little less like a workbench than I would have wanted.
But note--because each window is a browser window, if TCP is running, you can bring in a web page among the pages. If the web page is your own and you have FTP access to the directory, ant FTPMount (see more later) you can integrate your website directory with your local ones in your operations.
WWWworkbench startes with only a limited number of arexx commands in the browser. (basically all WWWworkbench needs is the command for a new window, load a new document, query title, and that;s about it--the rest is Arexx and Amigados). Additional commands offered by the browser add frills, like sizing the window, etc.
I'm not a programmer. And this is not a true program. It is a system of interrelated and interdependent scripts and html documents triggered by links on the browser display, and feeding the browser script-generated html documents. And this is the FIRST version, so many improvements in tightening and improving scripts, operations, etc. are inevitable.
HOW CREATED
Programmers tend to design a computer program from the point of view of acheiving a very fast and efficient script that does many things. But the ninterface and operations may not be as good as when the project starts with the iinterface, and works backwards. I'm not a programmer, but come from the real world of art; so my prime interest is the interface and operation. Making the operation and interface the greater importance may result in less efficient opeerations underneath, but the way I look at it its that if the arexx script takes a second longer to do something, so what? If we are talking only about an additional second here and there, that is insignificant in this application, because the user does not race along anyway.
It is inevitable from the way I build the thing, that the script is initially messy and in some respeects not doing something the best and fastest way. I am still a student of arexx. WWWworkbench was built up interractively. First you get something happening and then add and change this and that. It becomes more and more complex and messy; but when it is running properly it can be rewritten, tightened up, after turning attention to the script operation as opposed to the user interface. The objective is to get the final operation first, and then to tighten up the scripts afterward.
FEATURES
- APPLICABILITY TO REMOTE WEBSPACES VIA FTPMOUNT
Because of its applicability to internet use, I thought, why not call it WWWworkbench. The "WWW"coming from "World Wide Web". If you use it along with FTPMount, it realy does feel like a workbench that is not limited to local use, but which can work on the world wide web, dealing with remote directories via the internet channels.Through the use of FTPMount, WWWworkbench can include the remote website into the workbench as well. FTPMount by and ©Evan Scott, available on aminet, is a filesystem that places remote directories, to which you have FTP access, on your workbench. When you use Amigados commands on these local mirrors, FTPmount communicates as required with the remote computer to achieve what the Amigados commands require. The FTPMount system allows remote directories to in effect become part of your local workbenchwell. Such remote directory involvement makes WWWworkbench a true worldwideweb workbench.
- WORKBENCHLIKE OPERATION
Thus the name suggests what it is and does when configured in the intended way. Thus, WWWworkbench displays the
contents of directories in graphic manner, with browser
windows acting like workbench windows. As many browser windows can be
opened as desired, and, if the navigation buttons, etc are
removed, it actually has a workbench-like character. The
graphic display of the directories are based on the inbuilt
abilities of the browser to view files, both internally and with
external viewers. Those images that can be scaled are scaled
to thumbnail size. Other files are shown as boxes.
- LINKS LAUNCH AREXX SCRIPTS
Through
installing SYS:REXXC/RX as an external viewer (for IBrowse) , links in the
html pages are used to trigger arexx scripts which send
Amigados commands for editing (delete, copy, clone, etc). If
you have FTPMount, the editing capabilities are extended to
remote directories. This capability is limited to FTP-editable
remote directories that are ALSO internet websites accessible
by URL.
- IDEAL FOR WEBSITE DESIGN
WWWworkbench is ideally used for work in website design. In website design , many kinds of graphic elements are brought together, orchestrated; and in order to do it well the designer needs to be able to have a good overview of all resources starting with the graphics. WWWworkbench displays the content of entire directories--website directories being developed locally before being uploaded-- in as many windows as you want to open. It also allows you the ability to copy, files between directories, delete, move, clone, etc..
- THIS VERSION DESIGNED FOR IBROWSE 1.2
WWWworkbench 1.0 is designed for IBrowse 1.2. TThe user will wonder why so many requesters pop up, etc. Well that's because on one fundamental limitation . If I create a link that launches an arexx script there is no way to pass an argument to the script like which image is being clicked. Thus there is no way I can tell the script to , for exampel, open on the clicked directory, as there is no way to tell it which directory I am clicking. There is one crude way to do this--to cause the directory to be 'viewed' (IBrowse shows an index of that directory) and then extract the directory name from the URL. It slows it all down. AWeb-II 3.1 on the other hand
allows arguments to be passed to the arexx script, and perhaps the next version of IBrowse will provide such usefulness too in its arexx interface.(?)
WHAT IT IS AND WHAT IT DOES
- A SYSTEM OF SCRIPTS
Although WWWworkbench looks and feels like a separate software, it is nothing more than a cleverly organized system of arexx scipts. Note that WWWworkbench is only hosted by the supported Amiga browser and all the possibilities built into it are useable. All WWWworkbench does is use AmigaDos commands, orchestrated by Arexx scripts, to generate html docs on the fly, which the browser loads. Thus the browser is always dealing with html docs, urls, etc. and all the browser functions are usable--viewing, downloading, delaying image loading, logging, caching, and so on.
- A THUMBNAIL DOCUMENT GENERATOR
WWWworkbench generates the thumbnail docs on-the-fly and they are temporarily placed in a special drawer Ram:W4. Some files in there are not deleted as they may be reused, but the thumbnail docs are deleted after they are loaded. Some may find these thumbnail docs useful (you can build an archive-viewing website on a CD, for example). To save them, just fetch them from the IBrowse cache soon afterward and save them wherever you want.
AREXX SCRIPTS AND WWWw
It is important to note that unknown
arexx scripts are dangerous . By running an arexx script, you are allowing the creator of that script to operate your AmigaDos commands. (And this is also true of installation scripts when you install software--poor docs don't tell you what the installation script will do.) Anyway, the most dangerous thing would be if a bad, or evil arexx script deletes directories. My suggestion is that before you run any unknown arexx script search it for the word ALL, because 'Delete ALL' will not ask your permission to delete a directory. Normally arexx scripts will delete only files that they created in Ram: or Ram:T . So for your information, here is what WWWworkbench does in terms of creating or deleting directories and files: It creates a temporary directory, Ram:W4 , and EVERYTHING WWWworkbench generates and/or deletes is put in there. It doesn't even use an environmental variable. Instead a file called 'resultstring' is created and overwritten in this location. The only creation or deletion action that WWWworkbench does outside of Ram:W4 is to save a permanent configuration file ( W4-config.txt ) to the WWWworkbench directory.The directory Ram:W4 will remain until you reboot or explicitly delete it. The few script files in RAM:W4 are so small in filesize that they barely take up any memory. If it is a problem for anyone, just open Ram: and delete it.
Installation & Configuration
INSTALLATION
- 1. Aftere de-archiving the -'lha ' file you will find a directory
called WWWworkbench. To install, just copy (or drag on the
workbench) this drawer into the browser programdirectory
(the same directory as the actual browser program
is located)
- 2.Configure the supported Amiga browser ( IBrowse 1.2 ) to be able to launch WWWworkbench.
Go to the browser 'preferences' or 'settings' menu (IBrowse:Preferences-General-Arexx ) and create an Arexx menu
item for the browser's drop down arexx menu, so that you can launch
WWWworkbench from the menu. A good label would be
'START WWWworkbench'. You will also need to install the path to the appropriate file which is StartWWWWworkbench.ibrx. NO OTHER SCRIPTS NEED BE INSTALLED: All other arexx scripts are launched from links--which brings us to the next important
step--the ability of the browser to launch arexx scripts from the link.
- 3.CONFIGURE THE BROWSER TO BE ABLE TO LAUNCH AREXX SCRIPTS:
3 IBrowse:
Configure the RX program of the Amiga, which is on
Workbench 3.0 located at Sys:rexxc/rx , AS AN EXTERNAL
VIEWER. To do this, go to Preferences-General-External
Viewers. Click ADD and enter as MIME TYPE: arexx
Under EXTENSION enter ibrx . Under ACTION select
external viewer . Under viewer write the location of the RX
program (it will probably be Sys:rexxc/rx . Under
ARGUMENTS you'll have %f . Click OK
- 4.Select SAVE SETTINGS to save these changes (or they
will be lost when you exit)
- 5.Select from the supported browser AREXX menu, the label you
installed (START WWWworkbench), to see the title page
load into the browser window.
If you did as above, and your browser is running on Workbench, the program will work fine. IF YOUR BROWSER RUNS ON ITS OWN PUB SCREEN READ ON..
- 6.The file requesters, by default will appear on 'Workbench' screen. If you are running your browser on another public screen, like a separate IBrowse screen, you need to specify it in the configuration file so that file requesters will appear on the same screen. IBrowse is put on another screen by selecting it via the MUI configuration, and I don't know how to internally get the screen name. Just make sure the screen name in the config file is the one the browser runs on, or else the requesters will appear on workbench. Personally I run IBrowse on workbench.
CONFIGURATION
- WINDOW SIZES AND POSITIONS:
In the ideal use of WWWworkbench , you want to open a number of windows that do not fill the entire screen so you can move them around as on a table (which is also the original concept of the workbench). Thus you do not want every new window to open up full screen, forcing you to resize it every time, but perhaps about a third of tis width and height. Thus your ability to encourage the browser to generate new windows in the desired smaller sizes is important. To establish window size and position, you change the current window manually, and then Save the Settings. Subsequent windows will follow the new settings.
- FONTS:
For the file names, filesizes and dates to fit, you need the smallest size font you are comfortable with, otherwise you cannot make the thumbs very small. The generated html code uses FONT SIZE= 1 (ie -3, smallest) for the thumbnail pages. WWWworkbench has been designed with Times 11 as the smallest font. Note it is more important that the font be compact sideways--ei condensed-- rather than vertically. Another good choice: Universe 9 is about as small as you can get while still being readable. Both of these came with the Amiga.
- LAYOUT:
Obviously in this form of browser use, you do not need all the periferals for navigating the internet. IBrowse allows you to remove all or some in the Preverences-General-Layout section, at the box labelled WINDOW . If you un-checkmark them all you will get a plain box just like a workbench window (hence the name WWWworkbench ). All operations are still available via the pulldown menu at the top.
When you go on the internet via FTPMount, you may want to have the gadgets so you can see information about the loading, etc.
- SCREEN:
Some people will be running their browser on workbench, others will have it on a separate public screen. As also mentioned elsewhere, you need to make sure that the screen specified in the configuration file is the one that your browser is running on. Refarding the capacity of your screen--obviously the greater resolution you are capable of the better, as you have a larger worktable. WWWworkbench is designed for an 800x600 (SVGA) screen and a graphics card that shows photo images in true color.
- CONFIGURING THE THUMBNAIL DISPLAY
If you click CONFIGURATION on the start page you will get a display of the configuration file that applies to the browser that is running. Since you can see it on the browser page, you can go to the browser source editor and alter it. Then save the changes. To summarize you can modify the width, height, spacing, and number of thumbnails across the page of the generated rectangles(thumbanils, etc). Recommended thumbnail sizes are 80x60, 100x90, 160x120 because they are in the ratio of common jpeg files (320x240m 640x480), so most images will not appear to be distorted. More important is your control of the filesize that the browser will load and scale to thumb size. If you have a large file among small ones, the generation of the display will get hung up with the time it takes to load the large file and scale it down. On the internet, web pages rarely have image and graphic files more than about 15 kilobytes. The variable is called maxautosize. If you set it at 15, then the browser will load, if it can, all files under 15k. Your choice of the maxautosize will depend on computer speed. (and speed of phone line transmission if you are using FTPMount and the WWW.)If you are loading local files with an accelerated computer you might do fine with 200k.
- CONFIGURING FOR FTPMOUNT USE
While WWWworkbench was designed for viewing local directories, the clever system called FTPMount ©by Evan Scott and available from the Aminet , is utilized by WWWworkbench to allow you to manipulate your website , by the FTPMount system of making remote directories appear as workbench directories and files, which are operated by regular Amigados commands (delete, rename, copy, etc.). WWWworkbench is limited to those FTP directories which ALSO are accessible by the WWW. The way it works is that all refreshing and viewing is done by the regular browser WWW acces to your website, and that FTPmount is only used to edit the same directory via Amigados commands sent by WWWworkbench scripts to the local mirror icons of FTPMount . Because of this separation between FTPMount access and the browser's WWW (ie http://) access, configuration requires that you tell WWWworkbench the exact http:// address for a particular directory in the local FTPmount:. directories. Choose the highest level that is relevant. FTPMount is designed so that the volume FTPMount: contains a drawer icon for each FTP address you can access. The login information can be the name of the drawer, but usually people give a short name, and put the login information (host, userid, password, into the ToolTypes). Let's say that your website, according to the FTP path is located --according to the FTPMount system--at FTPMount:mywebsite/public. You will have to tell WWWworkbench via the configuration file how to reach the same place via an internet URL (an http:// address) an address like http://www.myserver.com/~myname/ . What happens is that WWWworkbench will test a directory that you attempt to load from an FTMount: drawer. If it detects 'FTPMount:' in the selected path name, it consults the configuration file for the equivalent URL. If it finds the FTPMount: path of the selected directory in the list, it then grabs the parallel 'http://xxx' address, and continues as normal, treating the FTPMount: directory like a normal workbench directory.
Some additional notes, if this is not boring you: You may wonder why the browser shouldn't also load directories and files via FTPMount , by using the local url file://localhost/FTPMount:mywebspace/pub/myfile.html instead of going on the www and using http://www.myserver.com/~myname/myfile.html. Well first of all---the browser crashes! Secondly, even if it did work what would in fact have to happen is that FTPMount would first download it to your computer, and then the browser load it from your computer, an additional step. And what happens if the file is huge and you want to abort? Things become complicated. It is much easier to have the browser handle all situations for viewing, which the browser does best, directly via http://, and FTPMount only be used to edit the remote website via Amigados commands
Thus to summarize---first get FTPMount , and learn to use it in regular AmigaDos fashion on the workbench. Then determine exactly the path you would need to actually reach the index.html (default.html, home.html) page of your website. Put that workbench path into the WWWworkbench configuration script following the FTPM.n=.Next , after a WWW.n= enter exactly what you would have to enter in the URL field of the browser TO REACH THE SAME PLACE. (but do not include the 'index.html' Just give the directory, ending it with a slash '/')
Note that because the windows are browser windows, you can go on the internet in the regular way on another window even as you are working on the local directories or FTPMount directories on previous windows. Open as many windows as you need for whatever you're doing.
Useage
GENERAL
The concept here is that you have several windows open at the same time, reduced from screen size so you can view two or three directories at the same time. You can then perform operations between them--copy or move pictures from one directory to another, delete this or that, rename for greater clarity... A good approach for such operations is to place two vertical half-screens side by side , dividing the screen in two. Set the number of pictures in a row to about three or four (depending on how small the thumbnails.). Note that the moment you apply the changes to the configuration window, it takes effect (but only until you turn the computer off, since the changes aare initially in Ram: To make the changes permanent use 'Save New Config' (which actulaly runs StartWWWworkbench again, which contains a COPY command that puts whatever is in Ram: to the W4config.txt file in the WWWorkbench drawer on your hard drive). Anyway, the point is that since changes are immediate you can change the thumbnail size, number across, and the maximum filesize allowable to be loaded to thumbnail--ANYTIME. You can even keep the configuration screen minimized and tucked away in a corner. The act of saving (IBrowse) the edited page immediately rewrites the config file in Ram, which the WWWworkbench.ibrx script reads every time it opens a new directory. Thus you are not stuck with a configuration!
The following is an inventory of specific things you can do:
VIEWER OF CONTENTS OF DIRECTORIES
- DISPLAY OF CONTENTS OF DIRECTORY
On every display there is a drawer icon/ There may or may not be drawer images within the file contents.When you select any DRAWER icon, you will be provided a requester to select a directory to load. The requester has a file field, therefore select a drawer (the file field remains blank).
- DIRECTLY VIEW A FILE:
if you DO choose a file, the WWWworkbench script directly tells the browser to laod that file to view; and the generatiuon of the display of the directory is bypassed. This is a good way of checking a specific file directly without going through the loading process.
If only the directory is selected and the display of the contents occurs: The script will generate an html document and have the browser load it, fetching the images etc required.
The size , spacing, number across are determined by the configuration file which you can edit.
INFORMATION ABOUT THE FILES:
- BIG FILES:
You also configured the maximum filesize that the browser will load so that the display will not be bogged down by large files. Large files other than images are also recognised so that you can visually see where the large files are. An icon image with BIG FILE is shown for easy detection.
- THUMBNAIL IMAGES:
Acceptable image files that the browser can load and scale are loaded and scaled to the thumbnail size.
- NON-IMAGE FILES:
Files that are not images--audio, anim, pic files that have no extension, etc. appear as empty unloadable boxes. HOWEVER THEY REMAIN CLICAKBLE. If you have an external viewer configured for that file--audio player, animation palyer, etc.--then clicking the empty rectangle will result in your being able to hear, view, etc.
- HTML DOCS:
The exception to the above are HTML documents (web pages). It is useful to identify them as in a browser environment they are significant. If you click them, you see a web page. Thus a website directory can be browsed in a non-linear fashion by picking our various html pages in teh display to click.
- FILENAME, FILESIZE, DATE
Most importantly, in addition to displaying all the files in one way or another, and making them all clickable, name, filesize, and date information is written below each image.
GENERATION OF THUMBNAIL HTML DOCS FOR ARCHIVES
WWWworkbench generates the directory displays into html documents which then the browser loads. You can choose to suppress deleting these, and allow them to accumulate in the Ram:W4 directory so you can copy them to a hard drive location to build a local website with a menu of links that could serve to view picture archives. Enter your desire to not delete these html docs in the configuration file.
DIRECTORY MANAGEMENT AND EDITING
Each display provides a number of menu items that trigger AmigaDos commands -- Delete -- CopyTo -- MoveTo -- Rename -- Clone -- MakeDir -- DelDir (delete directory). The system is designed so that you select the desired file from the file requester. Where applicable, multiselect is allowed. Note the destination directory for copy and move are another open window, which you can select. Prompts will help you understand how it works, so there is no need to cover all the details here.
NAVIGATION NOTES
- BIG DRAWER ICONS
These represent drawers (directories) found within the displayed directory. If you click them you will get a requester by which you can open another window that shows the content of that directory.
- TWO SPECIAL WINDOW-RELATED BUTTONS
- LOADNEW--Unlike the SRAWER icons which generate a new window. LOADNEW will load a new directory in the SAME WINDOW.
- CLONE--when clicked, a new window will be created AND it will be filled with the SAME contents as that of its parent.
SPECIAL AREXX BUTTON
(this concept is in development-send in your shareware to keep updated)
This button is designed for you to select a special arexx script which will act on an image. You first select the operation, and then select the image that you want the script to act on. The script waits for the url of the window to change, and assumes the change is the image that is to be acted apon. I provide two scripts--one passes the image to Image FX and the other passes it to PPaint. It is just a quick way of loading either program after viewing the directories with WWWworkbench.
EDITING REMOTE WEBSITES VIA FTPMOUNT
Once you have provided WWWworkbench the paths to the remote website directory in terms ofboth the URL and the FTPMount: path, WWWworkbench will go to and load a remote directory just as if it is local. The only way you will know you are going to a remote directory are the FTPMount prompts which indicate what is happening with your FTP connection. Also, of course, things will happen much mroe slowly as everything has to travel through the phone lines.
Because the approach used is that FTP is used for editing the directory, but HTTP: is used for fetching files to view, WWWworkbench works only on remote directories which are BOTH accessible to you via FTP and HTTP (ie the World Wide Web) This means you have established a personal or commercial website on your server.
UNDERNEATH EVERYTHING IS PRETTY TAME
As mentioned elsewhere, when I tried to load a remote file into the browser (IBrowse ) by the url "file://localhost/FTPMount: websitedrawer/website" the browser crashed. I did not continue to figure out why, because I decided anyway that it was better for the browser to access the files via HTTP: (ie via "http://websiteserver/website")directly instead of getting it indirectly, anyway. I believe the way I have done it is very ordinary and safe. FTPMount only recieves Amigados commands, which is the true concept behind FTPMount, and has no direct connection with the browser. And all the browser does is what it was meant to do--to load files via HTTP: And between the two WWWworkbench processes script data, generates html documents and sends AmigaDos commands to FTPMount or local files, and sends the browser about three arexx commands. Thus all participants are behaving in the way they were intended. And that makes the operation of WWWworkbench very normal and tame underneath.
Registration, Legalities, etc.
SHAREWARE
Become a registered user and recieve any new improvements to the version 1 (based on IBrowse as it exists currently (Sept 98). WWWworkbenchIB (IBrowse Version 1,0) is offered according to the shareware concept. The price set is $5 US. For registration just send me a letter with payment and your information---MOST IMPORTANT YOUR EMAIL ADDRESS because that is the only way I will send you the material. Questions? Ask me:email.
WWWworkbench is a design is based on real world experience, and it is not a toy. Examples of websites of mine (click hre and they will appear in this window--you have to expand the window to fill the screen)
an international resort
a medium size resort
my own website of wildlife paintings
SEND LETTER TO:
Andres Pääbo
Box 478
Apsley, Ontario
CANADA, K0L 1A0
EMAIL
STANDARD LEGALITIES.....
- COPYRIGHT
Copyright 1998 me, at the above address. Since the WWWworkbench is not just one script but a systematic operation of scripts, copyright relates also to the overall system, and not just individual scripts. As mentioned, WWWworkbench does not merge in any abnormal way with the web browser or FTPMount. For all copyright, legal, etc issues relating to the browser you are using or FTPMount please see their documentation.
- THE USUAL DISCLAIMER-
"This software is provided "as is" . No warranties are made, either expressed or implied, with respect to reliability, quality, performance, or operation of this software. The use of this program is at your own risk. The author of this software operation assume any responsibility or liability for any damage or
losses resulting from the use of this software, even if advised of the
possibility of such damage or loss. "
- LICENCE-SHAREWARE
Free use of WWWworkbench is limited to initial testing, experimenting. Once you decide you want to keep it to use again and again, you must legally get liscenced by getting registered . See the 'SHAREWARE' section above.